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1. THE BASIC COMPUTER 


The basic VZ-2008 computer employs a 2Z-8@A microprocessor (U4) 
running at a clock speed of 3.58MHz. Two 8K x 8-bit 
mask-programmed ROMs (U9,U1@) contain the Microsoft BASIC 
interpreter, while three 8K x 8-bit static RAMs (U2',U3' and 
U4') provide program memory. 


A 6847P-1 video controller chip (U15) and a further 2K x 8=bit 
static RAM (U7) form the heart of the computer's video section, 
These are coupled to the processor data bus via an octal 
bidirectional buffer, Ul4. 


A simple software scanning scheme is used for the keyboard. The 
keys are arranged in eight rows, each of which can be pulled 
down to low logic level by diodes connected to the eight least 
significant address lines (A9-A7). The other sides of the keys 
are connected to six column lines, which are connected to six of 
the inputs of a gated octal buffer (U12), and also to six pullup 
resistors. The outputs of the six corresponding outputs of U12 
connect to processor data lines D@-D5. 


Cassette input is handled by a simple one=-transistor circuit, 
together with one of the remaining elements of U12 (D6). 
Cassette output is taken from Ul, an 8=—bit latch, via outputs Ql 
and Q2. Other outputs from this latch are used to operate the 
internal piezo speaker (06 and 05, used in push-pull), and to 
control the mode (Q3) and background color (Q4) inputs of the 
video controller chip. 


Simplified decoding is used for selection of the various I/O 
devices in memory space. The decoding is performed by U2 and U3. 
The memory address ranges (in hex) occupied are as follows: 


6006 —- FFF: BASIC ROM @ 
2006 - 3FFF: BASIC ROM 1 
4606 - 67FF: Not occupied in basic unit 
(Used by ROM/game cartridges) 
6800 - 6FFF: Keyboard matrix + cassette input (Read) 
Cassette output, speaker, VDC control (Write) 
7009 - FIFE: Video RAM 
7868 - SFFF: Inbuilt program RAM 
9906 —- FFFF: Not occupied in basic unit 
(Used by expansion RAM modules) 


Note that due to the simplified addressing, latch Ul serving the 
cassette output, speaker and video display controller 
effectively occupies all addresses from 68@0-6FFF inclusive. 
Similarly the keyboard/cassette input buffer U12 also occupies 
all of this address range, although the individual rows of keys 
effectively occupy discrete addresses, 


A memory map showing both hex and decimal address is shown 
overleaf. 
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Decimal 


65535 


61440 


57344 


53348 


49152 


45956 


49966 


36864 


32768 
36728 
28672 
26624 


24576 


26480 


16384 


12288 


8192 


4896 





2. VZ-288 MEMORY MAP: 


Hex 
FFFE 


FOG? 
E6@6 
DAD 
COa88 
BOOS 
AQBd 
9880 


ween en = —- =~ —------} 8908 
7806 
7898 
6898 
6599 


5888 
4906 


38698 


(ROM 1) 


ee eee 


(ROM 9) 


196¢@ 
(ROM 9) 


8888 


a oe 


RESERVED FOR 
MEMORY EXPANSION 
(16K MODULE 
EXTENDS RAM 

TO CFFF) 


INBUILT USER 
RAM (6K) 
VIDEO RAM (2K) 


KYBD,CASS ,SPKR 


RESERVED FOR 
ROM CARTRIDGES 
(10K) 


BASIC ROMS 
(16K) 


3. THE KEYBOARD MATRIX 


As explained earlier, the 45 keys of the V2-20@ keyboard are 
arranged in an 8 x 6 matrix scanned by the eight least 
significant address lines. This means that each row of the 
keyboard matrix effectively occupies a specific memory location 
(or more accurately, a series of memory locations, due to the 
Simplified decoding). The individual keys are mapped into the 
corresponding bits of that memory location, according to the 
column they occupy in the matrix. 


The keyboard is scanned by the software taking each of the eight 
address lines down to logic low level in turn. If a key is 
pressed, it effectively “pulls down” the bit line at the address 
for its row. For example if the "2" key is pressed, this causes 
bit 1 to drop to @ at address 68F7 (also 69F7, GAF7, 6BF7, 6CF7, 
6DF7, 6EF7 and 6FF7). Providing no other keys are pressed in 
that row, the data retrieved by reading that address will be 3D 
hex (binary 111181). 


The keyboard matrix and its (lowest) row addresses in hex are 
Shown below. Note that each key causes a logic @ to appear at 
the bit position shown, when its row address is read. 





BIT POSITION 5 4 3 2 1 ) 
ROW ADDRESS 68FE R Q E W T 
68FD P A D CTRL S G 
68FB V Z C SHFT X B 
68F7 4 1 3 2 5 
68EF M SPC, . N 
68DF 7 4) 8 - 9 6 
68BF U P I RETN O Y 
687F J H K L H 


4. I/0 MAPPING: 


The Z-88A microprocessor used in the VZ-2808 can address 256 
ports in I/O space. Tentatively the following I/O address ranges 
have been set aside for expansion peripherals: 


I/O ADDRESS (hex) DEVICE 

68 - GF Printer 

186 - 1F Floppy disk controller 
26 - 2F Joystick interface 

36 - 3F Communications MODEM 
76 - VE Memory bank switch 


5. CASSETTE/SPEAKER/VDC OUTPUT LATCH: 


AS noted earlier, write-only latch Ul is used to provide the 
cassette output signal, the drive for the internal piezo 
Speaker, and two control signals for the video display 
controller (VDC) chip. The latch effectively occupies all of the 
addresses from 6886 - GFFF (decimal 26624-29671) inclusive. the 
bit map of the latch is shown below: 


WEIGHTING BIT FUNCTION 
Hex Dec 





28 32 Speaker B 
18 16 vDC background colour 
88 8 vDC display mode 
94 4 Cassette out (MSB) 
G2 2 Cassette out (LSB) 
G1 l Speaker A 
A. Speaker 


The speaker is driven in push-pull fashion by bits @ and 5. To 
make the speaker sound a note, the software should toggle bits 6 
and 5 alternately at the required rate. When bit @ is a logic 
"1", bit 5 should be logic "@" and vice-versa. Note that when 
this is done the software should not disturb the other bits of 
the latch. 


B. Cassette output 


Bits 1 and 2 are used to generate the cassette recording signal, 
which is approximately 175 millivolts peak-to-peak. 


C. VDC display mode 


The VDC display mode is controlled by bit 3. If bit 3 is a logic 
"9", the VDC will operate in its text/low-res mixed mode. If bit 
3 is taken to logic "1", the VDC operates in its hi-res graphics 
only mode. 


D. VDC background colour control 


Bit 4 is used to control the VDC background colour. In 
text/low-res mode (mode 9), a "8" in bit 4 gives a green 
background colour while a "1" in bit 4 gives an orange 
background. In hi-res mode (mode 1) a "68" in bit t ofves a green 
background, while a "1" gives a buff background, 


6. VIDEO DISPLAY MODES 


The VZ-200 has a total of 2K bytes of video display RAM, located 
in memory addresses 7680 - 77FF hex (28672 -— 38719 decimal) 
inclusive. When the video display controller (VDC) chip is 
operating in its text/lo-res mode (mode 9), only the first 512 
bytes of this video RAM are used. This is the default mode, 
entered on power-up. When the VDC is switched to its hires 
graphics mode (mode 1), all of the video RAM is used. 


A. TEXT/LO=RES GRAPHICS MODE (MODE 86) 

In this mode the video screen is organised as 16 lines of 32 
characters. Each character displayed on the screen corresponds 
to a single byte in the first 512 addresses of video RAM (7866 - 
71FF hex, or 28672 = 29183 decimal). 

A total of 256 different characters can be displayed in mode 6: 
128 alphanumeric characters, and 128 lo-res graphics characters. 
The most significant bit (B7) of each character code is used to 


determine whether an alphanumeric or graphics character is 
displayed. Details of the coding used are shown below: 


(1) Alphanumeric characters: 


6—-bit ASCII char code 
Oooo 
g 
1 

g 


= ALPHANUMERIC CHARACTER 





NORMAL CHARACTER 
INVERSE CHARACTER 


a 


(11) Programmable ({lo-res) graphics characters: 


Graphics character code* 


a 
C CHARACTER COLOUR CODE 


1 = GRAPHICS CHARACTER 


*The graphics character coding used is quite simple. Each bit 
corresponds to one cell of a 2 x 2 pixel matrix which occupies 
the same screen area as an alphanumeric character: 





The 3-bit colour code is as follows: 


B6 B5 B4 HEX COLOUR 
@ g g 50 Green 

6 @ fl 16 Yellow 
g a 4) 28 Blue 

G 1 1 39 Red 

i 8 Q 46 Buff 

1 g 1 o@ Cyan 

1 1 0 6g Mayenta 
1 1 1 716 Orange 


To summarise, the total mode (@) character set available is 
Shown below, Note that these are the characters displayed if the 
codes concerned are written directly into the screen RAM -- 
1.@., uSing POKE statements or from a machine code routine, 


V¥Z-200 SCREEN CHARACTER SET 


®@i2¢293483 6 7 86s A 8B C CO E F MSB 
LSB @g ec P G@;@ P 8 

1 AR G tif®R @ | Lie oe 8 8 8 ® 8» 8 
2 BR" 2:8 R “" 2@t} «a 8 » 8 @ 8» @ @ 
3 C$ # 3GIiC S$ # Sima me aeeseeaseea 
& D TF &§ 4;0 T &$ 4)" *&© © &©& 8& 8 8 8 
Ss Eu=* SiEu * S|f' © &£ 8 8 8 @ 8 
€ F Vv @ 6/F V & 6/47 #& fF € # # # # 
7 GW * FIG Ww ° Fi d & @ OB A A De OD 
8 H KX ¢€ B8{(H &® € B® * *§ F&F FF F # 
g I y¥ 39 9II ¥Y 29 FSIi*% & & ®* % & S® & 
a J 2 ! J £ * « 18 F 8 &€ 8 @ &€ 8B 
 -| K CC + 3} 1K CC + js |e & & & & w& & & 
C L x ) < L XY , ¢ ones oes es ss 
D et J - = im FF = «£ | TBE THT BW_W 
E N * , >iN * ,. FIT F FP FPP PP Pe 
F 0 =—- 7 710 * 4 F/8 FF Bess 8B B@ 

INVERSE G Y B R BF CNM OQ 


Note that when the PRINT CHRS (N) command is used, rather than 
POKE, the BASIC interpreter performs code conversion to make the 
display conform more closely to normal ASCII standards. Hence 
decimal codes 6 —- 31 become non-printing control codes, while 
codes 64-95 become those for the normal alphabetic capitals. As 
there are no lower-case characters available, codes 96-127 
duplicate the characters for codes 32-63. Codes 192-255 are used 
for the inverse alphanumerics, and codes 128-143 for graphics 
(with colour set by the COLOR M,N command). 


B. HI-RES GRAPHICS MODE (MODE 1) 


In this mode the screen is organised as 64 rows of 128 pixels, 
giving a total of 8192 pixels. Each pixel can be displayed in 
one of four colours, one of which is the background colour. This 
means that for each of the two possible background colours, each 
pixel can be either “turned off" ({i.e., the same colour as the 
background), or displayed in one of three colours. 


The video RAM coding scheme used for this display mode uses each 
byte to encede four adjacent pixels. This means that each pixel 
is encoded in two bits. To illustrate this, here is the coding 
for the first four pixels on the screen, up in the top left-hand 
corner: 


PIXEL 9 PIXEL 1 PIXEL 2 PIXEL 3 


wooness ro00: [Popo ]=[=]™ [alo 


The next four pixels along the line are stored in location 
76B81H, and so on. The 2-bit colour coding used for each pixel is 
shown below: 


(i) Backbround colour @ (green): 


8@ = GREEN (background colour) 
61 = YELLOW 

18 = BLUE 

11 = RED 


(ii) Background colour 1] (buff): 


0@ = BUFF (background colour) 
81 = CYAN 

1@ = ORANGE 

ll = MAGENTA 


Note that from BASIC, any pixel may be individually turned on or 
off using the SET(x,y) and RESET(x,y) command, and given various 
colours using the COLOR(m,n) command. 


Video display worksheets for both mode (@) and mode (1) are 
given at the rear of this manual. These can be very handy for 
planning the display screens, menus etc when you are writing 
programs. Feel free to photocopy these worksheets, so you can 
use the photocopies in this way. 
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7. VZ-286 SCREEN CONTROL CODES 


The following codes can be used for screen control from BASIC; 


Cursor left PRINTCHRS (8) 
Cursor up PRINTCHRS (27) Cursor down 
Rubout PRINTCHRS (127) Insert 

Home PRINTCHRS (28) 


8. SYSTEM POINTERS, ETC 


Cursor right PRINTCHRS (9) 
PRINTCHRS (10) 
PRINTCHRS (21) 
Clear screen PRINTCHRS (31) 


Here are some of the main system pointers and variable storage 


locations of interest to VZ-280 programmers: 


POINTER OR VARIABLE HEX LOC 
Top of Memory (ptr) 78B1/2 

Start of BASIC program (ptr) 78A4/5 

End of BASIC program (ptr) T8F9/A 

(also start of simple variables table) 

Start of dim. variables table (ptr) 78FB/C 

End of BASIC's stack (ptr) 7BAG/1 


(also start of string variable storage area) 


Execute address for USR program (ptr) 788E/F 
(note: high byte of address must go in 788F) 


Interrupt exit (called upon interrupt) 787D/E/F 


Start of BASIC line input buffer 79EB 
(buffer is 64 bytes long ~- 2 screen lines) 

Copy of output latch 783B 
Cursor position 78A6 
Output device code 789C 


(8 = video, 1 = printer, -l = cassette) 


DECIMAL 
38897/8 
38884/5 
36969/78 


36971/2 


30880/1 


38862/3 


38845/6/7 


31298 


38779 
36886 
36876 


The contents of the BASIC stack pointer stored in 78A®/1 are 
basically equal to the centents of the ‘top of memory’ pointer 
stored in 78B1/2, less a figure equal to the number of bytes 
reserved for string storage. The default value for string 
storage space is 5@ bytes; this can be modified from within a 
BASIC program by using the CLEAR command -- 1.e., CLEAR 1688 


will increase the string space to store ]1@#@8@ bytes. 


The VZ-208 printer interface uses I/O port address OE for the 
ASCII character code data and strobe output, and address @6H for 


the busy/ready-bar status input (bit @). 
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9. RESERVING SPACE FOR A MACHINE CODE PROGRAM 


There are a number of ways to reserve memory space for a machine 
code program, from within a BASIC program. But before details of 
these methods are given, we should clarify the way that BASIC 
normally organises RAM memory space. 


A range of addresses at the bottom of user RAM is reserved for 
system pointers and variables. This section is often termed the 
"communications region”. It includes locations which store 
pointers to the boundaries of the various regions in upper RAM, 
like the 'Top of Memory’ pointer, the ‘start of BASIC program' 
pointer and so on. The latter pointer is stored at 78A4/5 
(decimal 38884/5). 


Normally the BASIC program itself is stored next, in locations 
Starting at address 7AE9 hex. At the end of the BASIC program 
text, the system stores a table containing the program's 
variables. This is known as the 'variable list table’ (VLT). 
This is divided into two sections: first the simple variable 
table, containing simple numeric variables and pointers to the 
Simple string variables, and then the subscripted variable table 
containing dimensioned variables. 


As the, BASIC program text changes in length, the VLT is moved up 
or down in memory so that it always begins at the end of the 
program. The pointer to the start of the VLT 1S stored in 
location 78F9/A, and the pointer to the start of the subscripted 
variable table in location 78FB/C. 


The remaining major regions extend downward from the top of user 
RAM. Normally at the very top of RAM Is the string storage area, 
extending down from the top of RAM (pointer stored at 78B1/2) by 
either the default figure of 58 bytes, or a different amount 
established by a CLEAR N command, The BASIC interpreter's stack 
then extends downward in memory from the bottom of the string 
area (pointer stored in 78A®@/1). 


The space between the top of the VLT region and the bottom of 
the stack is not used, and is designated ‘free space’. So that 
normally, the RAM organisation looks like this: 


TOP OF MEMORY (TOM) 





Default:TOM-5¢8 bytes => 


ve (free space) 


_— VLT 

= BASIC program 

= Communications 
Region 


Normally 7AEQ9H --~=> 


START OF USER RAM 
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Method 1: This method of reserving space for a machine code 
program involves shifting the BASIC program area upward in 
memory from its normal start at 7AE9, creating a space 
immediately above the communications region. The machine code 
program can then be loaded into this space, probably by POKEing 
it from your main BASIC progran. 


Needless to say, the BASIC program area can only be shifted up 
before your main program is loaded into it (if 1t were done 
afterwards, the start of the program would be lost). But the 
shifting is quite easy to do, because all that is required is 
{a) to change the ‘Start of BASIC program' and ‘End of 
Program/Start of VLT’ pointers, together with ({b) creation of a 
new ‘null program‘ at the start of the new program area, 


This can be done quite easily by a small BASIC program which is 
fed into the computer ahead of your main program, Here is what 
it looks like if you want to reserve say 128 bytes: 


18 POKE 31593,9:POKE 31594,6:POKE31595,@ 
26 POKE 30884,195:POKE 39885,123 
36 POKE 36969,187:POKE 389768,123 


Here line 18 pokes a ‘null program’ of 3 zero bytes into the 
start of the new program area (which starts at 7B69H, or 31593). 
Line 2@ pokes the decimal equivalents of the low and high bytes 
of this new starting address of the program area into its 
pointer address, while line 38 pokes in the corresponding values 
for the new EOP/VLT pointer. 


Note that this shifting program ‘self destructs' -=— once you run 
it, the BASIC interpreter loses all knowledge of its existence 
in memory. So if you then try to LIST or RUN, nothing will 
happen because as far as the interpreter is concerned, it now 
has nothing in its (new) program storage area. 


Once the program has run, however, any BASIC program you load in 
will start at the new, higher address (here 128 bytes up), 
leaving the space immediately above the communications area free 
for a machine language routine or program. 


Needless to say you can vary the above program to adjust the 
amount of space reserved. You'll need to change both the values 
poked into the pointer locations in lines 28 and 38, and the 
poke addresses in line 16. 


Don't forget that if you use this method, the ‘reserving' 
program will have to be loaded and run ahead of the main 
program, every time you want to use it. The reserving operation 
can't be done from within the main program itself. 


This is one disadvantage of this method; another is that it is 


not easy to load in both your main baSic program and the machine 
language program directly from tape. 
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Method 2: With this method of reserving space for a machine 
language program, you create the required space in between the 
end of the main BASIC program and the start of the VLT, by 
shifting the VLT upward in memory. 


This is simpler to achieve than Method 1, because all that is 
required is to change the ‘End of BASIC program/Start of VLT' 
pointer stored in 78F9/A hex (decimal 38969/70). In effect, we 
‘fool’ the BASIC interpreter into thinking that the BASIC 
program is longer than it really is. 


How do you work out the new value for this EOP/VLT pointer? 
Probably the best approach is to PEEK at the value of the 
pointer when your main program is loaded in normally, and then 
add to this figure the amount you need for the machine language 
routine -= plus a.small amount (say 64 bytes) for safety margin. 


Let's say you again want to reserve 128 bytes, First load in 
your main BASIC program, then key in this command: 


PRINT PEEK (3@969) + 256*PEEK (32976) 


The answer you get is the current value of the EOP/VLT pointer, 
in decimal. In other words, it represents the actual end of your 
BASIC program. So add say 192 to this (128 plus a safety 
Margin), to get the new EOP/VLT pointer value. 


Say the value you get is 32800. Now find the decimal equivalents 
of the high and low pointer bytes for this figure, by keying in 
this line: 


P=32860:PRINT INT(P/256), P-—(256*INT(P/256)) 


The first number you get is the pointer high byte (in this case 
128), while the second is the pointer low byte (here 32). 
Obviously if you get a different value from 32809, key this into 
the above line to get the corresponding values, 


Now all you have to do is fit these values into a pair of POKE 
statements at the very start of your main BASIC program: 


1 POKE 38969,32 :POKE 38970,128 


This line must be right at the start of your program, so that 
the EOP/VLT pointer is moved before the program introduces or 
uses any variables. Otherwise the variables would be ‘lost’. 


This method allows you to load, save and run the BASIC program 
normally, witheut any prior preparation. Once you have loaded 
the machine language program into the reserved space between the 
BASIC program and its VLT, you can also save and re-load it 
along with the BASIC program, automatically. This is because the 
CSAVE and CLOAD routines use the EOP/VLT pointer to indicate the 
end of the BASIC progran. | 


Note that the 64=-byte ‘safety margin' allows for the small 
increase in program length when you add line 1 above. 
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Method 3: This method of reserving space for a machine language 
program involves changing the ‘Top of Memory' (TOM) pointer so 
that it points to an address lower than the actual top of 
memory. This forces the BASIC interpreter to move its string 
Storage area and stack downward, leaving a space for your 
machine language program at the top. 


Like Method 2, this is quite easy to do and it can be done from 
within your BASIC program. 


First, you need to PEEK the current value of the TOM pointer. 
This is found quite easily: 


PRINT PEEK(36@897) + 256*PEEK(36898) 


This will normally give you 36863 for a basic VZ-266, or 53247 
lf you have the 16K Memory Expansion Module plugged in, 


Then you simply subtract from this figure the amount of space 
you want to reserve for the machine language program, to give a 
new TOM address. Then it's simply a matter of poking the low and 
high byte figures for this address into the TOM pointer, at the 
Start of your program. 


For example, say you want to reserve 256 bytes, and you have a 
basic VZ-208 so the normal TOM is 36863. So the new artificial 
TOM will be 36863-256, giving 36607. To work out the two new 
pointer bytes in decimal, type in: 


T=36607:PRINT INT(T/256), T=-(256* INT (T/256) ) 
The First number you get is the pointer high byte (here 142), 
while the second is the low byte (here 255). If you have a 
different value for TOM (T), you'll get corresponding values, 


Having found these values, all you need to do is add the 
following line to the start of your program: 


1 POKE 30897,255:POKE 36898,142 


The pointer must be changed before the program uses string 
varlables and the stack, or the system could ‘crash',. 


Note that this method allows your BASIC program to be loaded, 
Saved and run normally. However it does not allow the machine 
language program to be loaded directly into the reserved area at 
the same time. The machine code must be loaded either 
separately, or POKEd into the reserved area by the BASIC program 
itself -- after the pointer is changed. 

18. FINDING THE TOP OF YOUR VZ-206's MEMORY 

This is quite an easy one -- simply type in tne line: 


PRINT PEEK(36897) + 256*PEEK (30898) 


11. CALLING A MACHINE CODE ROUTINE FROM BASIC 


The standard way of calling a machine language program or 
routine from BASIC is to use the USR(X) command. But before 
this command can be used, the starting address of the machine 
language routine must be loaded into the USR program pointer, 
Stored at address 788E/F hex {decimal 39862/3). This can be 
done uSing POKE statements. 


To illustrate this, let’s look at an example, Let's say you 
want to use the INKEYS function in your BASIC program, to 
accept input character=-by-character, But you'd like the VZ~204 
to give its usual ‘beep' each time to register input, and the 
INKEYS function doesn't provide this. — 


As it happens, the BEEP Subroutine’ in VZ=286's BASIC ROM can 
easily be called to do this, using the USR(X) command. The 
calling address for the routine is 345¢@ hex, so the decimal 
figures for the USR pointer bytes are 88 (low byte, equal to 5d 
hex) and 52 (high bytes, equal to 34 hex). 


So 1f you want to produce a 'beep' at various places in your 
BASIC program, all you need to do is put this line near the 
start of the program (before the first beep is needed): 


20 POKE 30862,86:POKE 30863,52 


This sets up the USR pointer. Then wherever you want a ‘beep' 
in your program, simply use the command; 


X=USR (X) 


Note that before control is passed to the user routine at the 
designated address, the value of the argument variable X is 
stored in locations 310469/31610 (7921/2 hex). So this can be 
used to 'pass' a parameter value to the user routine. If the 
routine doesn't need any parameters (like the 'beep' routine 
above), simply use a 'dummy' variable name like X, as shown, 


The same general technique is used for calling other machine 
code routines, whether they are located in ROM or RAM. It's 
Simply a matter of poking the start address of the routine inte 
30862/3, and then using the USR command, 


You aren't limited to calling a single machine code routine, by 
the way. You can call a number of routines in turn, simply by 
poking each routine's start address into 38862/3 before you use 
the USR command to call it. Just remember to POKE the right 
routine address into the pointer each time! 


12. USEFUL ROM SUBROUTINES FOR ASSEMBLY PROGRAMMING 


A. KEYBOARD SCANNING ROUTINE 


The keyboard scanning routine resides at 2EF4 hex. This routine 
scans the keyboard once and returns. If a key is pressed, the A 
register will contain the code for that key; otherwise this 
register will contain zero. Registers AF, BC, DE and HL are all 
modified by the routine, so if the contents of these registers 
must be preserved they should be pushed onto the stack before 
the routine is called. The following example shows how the 
routine would be used to wait for the RETURN key to be pressed: 


SCAN CALL 2EF4H :scan kybd once 
OR A fo jany key pressed? 
JR. 2,SCAN s;back if not 
CP @DH i> ;was it RETN key? 
JR NZ ,SCAN gback if not 
—s rotherwise continue 


B. CHARACTER OUTPUT SUBROUTINE 


A routine which outputs a Single character to the video display 
is located at 933A hex. The code for the character to be 
displayed must be in the A register, while the character will 
be displayed on the screen at the position corresponding to the 
current value of the cursor pointer. All registers are 
preserved. Here is how the routine would be called to display 
the word 'HI*, followed by a carriage return: 


LD A,‘H' gload A reg with code 
CALL 633AH :& display 

LD A,‘I' ;same for I 

CALL 9@33AH 

LD A, @DH snow load A with CR code 
CALL 933AH 7;& update screen 


C. MESSAGE OUTPUT SUBROUTINE 


A very useful subroutine located at 28A7 hex can display a 
String of character codes as a message on the screen. The 
string of character codes must end with a zero byte. The HL 
register pair must be set to the start of the string before the 
subroutine is called. All registers are used by the subroutine. 
Here is how it is used: 


LD HL,MSG z;load HL with start of strg 

CALL 28A7H 7& call print subroutine 
MSG DEFM ‘READY' z;main message string 

DEFB @DH ;carriage return 

DEFB @ snull byte to terminate 
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D. COMPARE SYMBOL (EXAMINE STRING) -- RST 68H 


A routine which is called using the RST @8H instruction can be 
used to compare a character in a string pointed to by the HL 
register, with the value in the location following the RST 98 
instruction itself. If there iS a match, control is returned to 
the instruction 2 bytes after the RST 98, with the HL register 
incremented by one and the next character of the string in the 
A register. This allows repeated calling to check for an 
expected sequence of characters. Note that if a match is NOT 
found, the RST 98 routine does not return from where it was 
called, but jumps instead to the BASIC interpreter's input 
phase after printing the SYNTAX ERROR message. Here is: how the 
routine is used to check that the string pointed to by the HL 
register is 'A=B=C': 


RST @8H stest for 'A’ 

DEFB 41H shex value of A for comparison 
RST @8H gmust have found, so try for ‘=' 
DEFB 3DH shex value of '‘'=' 

RST @8H :0K so far, try for 'B' 

DEFB 42H 

RST @8H snow look for second ‘=! 

DEFB 3DH 

RST @8H sfinally check for 'C' 

DEFB 43H 

eee smust have been OK, so proceed 


E. LOAD & CHECK NEXT CHARACTER IN STRING -—- RST 10H 


The RST 19H instruction may be used to call a routine which 
loads the A register with the next character of a string 
pointed to by the BL register, and clears the CARRY flag if the 
character is alphabetic, or sets the flag if it is 
alphanumeric, Blanks and control codes 99H and @BH are skipped 
automatically. The HL register is incremented before each 
character is loaded, therefore on the first call the HL 
register should be set to point to the address BEFORE the 
location of the first string character to be tested. The string 
must be terminated by a null byte, 


Here is an example of this routine in use. Note that if it is 
used immediately after the RST 98H instruction as shown, the HL 
register will automatically be incremented to point to the next 
character in the string: 


RST @8H stest for ‘=! 
DEFB 3DH 
RST 19H sfetch & check next char 


JR NC, VAR swill go to VAR if alpha 
‘ae scontinues if numeral 
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F. COMPARE DE & HL REGISTER PAIRS -- RST 18H 


The instruction RST 18H may be used to call a routine which 
compares the contents of the DE and HL register pairs. The 
routine uses the A register only, but will only work for 
unsigned or positive numbers. Upon returning, the result of the 
comparison will be in the status register: 


HL < DE carry set 


HL > DE : no carry 
HL <> DE : Na@ 
HL = DE : @ 


Here is an example of its use. Assume the DE pair contains a 
number and we want to check that it falls within a certain 


range -- say between 188 and 588 (decimal): 
LD HL, 508 zgload HL with upper limit 
RST 18H 7& call comparison routine 
JR C,ERR ;carry means num > 58d 
LD HL,1¢¢ snow set for lower limit 
RST 18h ;& try again 
JR NC,ERR sno carry means num < 186 
ae ae ;if still here, must be OK 


G. SOUND DRIVER 


Located at 345C hex is a routine which can be used to produce 
sounds via the VZ-288's internal plezo speaker. Before calling 
the routine, the HL register pair must be loaded with a number 
representing the pitch (frequency) of the tone to be produced, 
while the BC register pair must be loaded with the number of 
cycles of the tone required (i.e., the duration in cycles), All 
registers are used. The frequency coding used is inversely 
proportional to frequency, i.e., the smaller the number loaded 
into the HL register pair, the higher the frequency. As a 
guide, the low C produced by VZ-288°s SOUND command in BASIC 
can be produced using the decimal number 526, the middle C 
uSing 259 and the high C using 127. Here is how you would call 
the routine to get say 75 cycles of the middle Cc: 


LD HL, 259 s:set frequency code 
LD BC, 75 set number of cycles 
CALL 345CH :& call sound routine 


H. ‘BEEP' ROUTINE 

The routine which is used by BASIC to produce the short ‘beep! 
when a key is pressed is located at address 3459 hex. It 
disturbs all registers except the HL pair. All you have to do 
to produce a beep is call it: 


CALL 3456 ymake a 'beep' 
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J. CLEAR SCREEN 


A routine located at 91C9 hex may be used to clear the video 
screen, home the cursor and select display mode (6). It 
disturbs all registers, Again it 1s used simply by calling it: 


CALL 61C9 ;clear screen, home cursor etc 


K. PRINTER DRIVER 


The printer driver routine is located at @58D hex. To send a 
character to the printer, load the character's ASCII code into 
the C register and call the driver. After printing the 
character code will be returned in both the A and C registers. 
All other registers are disturbed, For example to print the 
letter ‘a' (ASCII code 97 decimal), you would use: 


LD C,9? ;set up code in C reg 
CALL 8S8DH 2& call printer driver 


A line feed character (@8AH) is automatically inserted after a 
carriage return (@DH). If the driver is called with a null byte 
in the ¢ register, it will simply check printer status and 
return with bit 6 of the A register either set or cleared. The 
routine does check for a BREAK key depression, and if one is 
detected, it will return with the carry flag set, 


L. CHECK PRINTER STATUS 


A routine to check printer status 1s located at @95C4 hex. When 
called it loads the printer status (I/O port @@H) into the A 
register and returns. Bit @ will be set (1) if the printer is 
busy, or cleared (9) if it is ready. No other registers are 
disturbed. An example: 


TEST CALL @5C4H scheck is printer is ready 
BIT Q,A stest bit @ 
JR NZ,TEST sloop if busy 
cee zsmust be ready 


M. SEND CR-LF TO PRINTER 


A routine located at 3AE2 hex may be used to send a carriage 
return and line feed combination to the printer. No registers 
need be set up before calling, but all registers are disturbed. 
If the BREAK key is pressed while printing occurs (or while the 
printer driver is waiting for the printer to signal ‘ready'), 
the routine will return with the carry flag set: 


CALL 3AE2 sgo send CR=<LF to printer 
JP C,BRK ;check if BREAK key pressed 
eee sapparently not 
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